UnoCSS 插件入口文件常见问题
在 uni-app 项目中集成 UnoCSS 后,使用 CLI 方式和 Vite 插件方式可能会产生冲突。本节解决 UnoCSS 入口文件的导入问题。
问题描述
当 vite.config.js 中配置了 UnoCSS 插件后,插件会检测 main.js 中是否有 UnoCSS 的导入语句。如果使用 CLI 方式导入(import './static/uno.css'),插件会报错或提示需要改为虚拟模块导入。
解决方案
方式一:改为虚拟模块导入(推荐)
将 main.js 中的导入改为:
// 原来的 CLI 方式(不再使用)
// import './static/uno.css'
// 改为虚拟模块导入
import 'virtual:uno.css'
javascript
同时注释掉 vite.config.js 中 CLI 方式的相关代码,完全交给 UnoCSS 插件维护样式文件的生成。
方式二:保持 CLI 方式
如果继续使用 CLI 方式,则不在 vite.config.js 中添加 UnoCSS 插件配置。
样式不生效的排查步骤
- 先重启调试进程:停止微信开发者工具 → 重新启动 HBuilderX 调试
- 如果还不行:删除项目根目录下的
unpackage文件夹 - 重新启动调试:删除缓存后重新编译
- 检查
static/uno.css:确认文件中有对应的样式规则
HBuilderX 开发小程序的缓存问题
使用 HBuilderX 开发微信小程序时,经常遇到缓存导致的样式不生效问题。处理流程:
样式修改后不生效
→ 重启微信开发者工具
→ 还是不行?删除 unpackage 目录
→ 重新启动 HBuilderX 调试进程
→ 确认 static/uno.css 已更新
text
建议:开发页面样式时优先使用 HBuilderX 内置浏览器,开发完成后再到微信开发者工具中调试,可以减少缓存问题的干扰。
↑